XSW

NAME

SYNTAX

DESCRIPTION

When xsw is invoked, a Main Control Panel (MCP) is displayed. A menu bar is position on top with three pull down menus:

File
      -Connect to a new server.
      -Disconnet a server.
      -Exit xsw

Options
      -Change fonts on a per server basis.
      -Change button actions.

Help
      -General Display Information
      -Options

Directly below the menu bar on the left side, is a box that contains a list of server(s) which xsw is currently connected to. The active server will be highlighted. The MCP will reflect the state of the active server. All connected servers will be updated according to their Target interval time (See Below). Only one server can be viewed on the MCP at a time. Directly below the menu bar and to the right of the server list is a message box used for displaying messages regaurding the active server. Directly below the message box are:

Target : What sampling interval is wanted for the active server. Arrow buttons change the interval.

Actual : The actual sampling interval obtained for the active server.

Users : The number of users for the active server.

Below the Target, Actual, and Users boxes, are toggle buttons used for displaying system resources. The resources available for viewing are:

CPU:

Displays cpu usage at actual interval, average cpu usage at actual interval * 5 , and average cpu usage at actual interval * 10. The cpu usage is broken down into: user time, sytem time, and break time.

WAIT:

Displays cpu wait usage at actual interval, average cpu wait at actual interval * 5 , and average cpu wait at actual interval * 10. The cpu wait usage is broken down into: I/O time, page I/O time, and swap I/O time.

Cache :

Displays disk cache read/write hit/misses.

Other :

Displays several tunable kernel structures:

       

NFILES The maximum number of open files system-wide. Each entry represents an open file.

       

NINODES The many inode table entries to allocate. Each table entry represents an in-core inode that is an active file.

       

NPROC The many process tabel entries to allocate. Each table entry represents an active process. The number of entries depends on the number of terminal lines available and the number of prcesses spawned by each user.

       

NREGION How many region table entries are used.

       

CBLOCKS How many cfree table entries are used.

       

CALLOUTS How many call-out table entries are used.

       

NMOUNTS How many mount table entries are used.

PS Cpu:

Displays cpu usage on a per process basis. The processes displayed can be those CURrently running and/or have run, or ALL process on the system. If CUR is choosen, then time can be shown as a percentage (%) of the interval or in Ticks for that interval. If ALL process is choosen, then time can be shown as a percentage (%) since boot or in Minutes:seconds. The following is displayed for PS Cpu:

       

S The state of the process at time of sampling. The follwing states are shown:

       

s The process is currently sleeping, waiting for an event.

       

R The process is currently running.

       

USER The user of the process. If the process is "set uid", then the "#" character will be appended to the user name.

       

PID The Process IDentification of the process.

       

CPU The cpu usage for scheduling.

       

PRI The priority of the process.

       

NI The nice value used for cpu usage.

       

UCPU Tser time of the process.

       

SCPU System time of the process.

       

U+S User + system time of the process.

       

SIZE Size of the process, according to the "proc" data structure..

       

TTY Tty associated with the process.

       

CMD The arguments from the execution of the process.

PS I/O:

Displays I/O on a per process basis. The processes displayed can be those CURrently running and/or have run, or ALL process on the system. If CURrent is choosen, then time can be shown as a percentage (%) of the interval or in Ticks for that interval. If ALL process is choosen, then time can be shown as a percentage (%) since boot or in Minutes:seconds. The following is displayed for PS I/O:

       

USER The user of the process. If the process is "set uid", then the "#" character will be appended to the user name.

       

PID The Process IDentification of the process.

       

SWAP The number of bytes to/from swap for that process.

       

CHAR The number of characters for that process.

       

READ The number of reads for that process.

       

WRITE The number of writes for that process.

       

TOTAL The number of read + writes for that process.

       

CMD The arguments from the execution of the process.

PS Mem:

Displays memory on a per process basis. Memory is displayed in memory "pages" and can be in Accending or Deccending order. There are several different VIEWs of memory:

       

Core Storage Only: Private & Shared:

          

USER The user of the process.

          

PID The Process IDentification of the process.

          

VSIZE The virtual size of the process. This is the maximum size that the process can grow to.

          

SHRD The number of pages that are sharable.

          

PRIV The number of pages that are private.

          

WTD The number of pages in a region that are valid divided by the number of process referenceing the region.

          

TOTAL The PRIV + WTD.

          

CMD The arguments from the execution of the process.

       

Core Storage Only:

          

USER The user of the process.

          

PID The Process IDentification of the process.

          

VSIZE The virtual size of the process. This is the maximum size that the process can grow to.

          

NONE The number of pages that are in core only.

          

SWAP The number of pages that are in core, but with a copy on swap.

          

FILE The number of pages that are in core, but with a copy on file.

          

LSTFILE The number of pages that are in core, but with a copy on file.

          

TOTAL Is NONE + SWAP + FILE + LSTFILE.

          

CMD The arguments from the execution of the process.

       

All Storage :

          

USER The user of the process.

          

PID The Process IDentification of the process.

          

VSIZE The virtual size of the process. This is the maximum size that the process can grow to.

          

NONE The number of pages that are in core only.

          

SWAP The number of pages that on swap.

          

FILE The number of pages that on file.

          

LSTFILE The number of pages that on file.

          

ZERO The number of pages that are zero filled.

          

FILL The number of pages that are fill.

          

IOMAP The number of pages that are io mapped.

          

WINDOW The number of pages that are window.

          

CMD The arguments from the execution of the process.

       

Secondary Storage All:

          

USER The user of the process.

          

PID The Process IDentification of the process.

          

VSIZE The virtual size of the process. This is the maximum size that the process can grow to.

          

SWAP The number of pages that are on swap only.

          

FILE The number of pages that on file only.

          

LSTFILE The number of pages that on file only.

          

ZERO The number of pages that have not been used yet.

          

FILL The number of pages that are fill.

          

IOMAP The number of pages that are io mapped.

          

WINDOW The number of pages that are window.

          

CMD The arguments from the execution of the process.

Streams:

Displays streams statistics. The following information:

       

Config What is currently configured into the system.

       

Use The current item usage count.

       

%Use The percent of Config in use.

       

Total The total item usage count.

       

Max The maximum item usage count.

       

Fail The count of allocations failures.

      

is shown for these streams sturcutres:

       

NSTREAM Stream allocation data.

       

NQUEUE Queue allocation data.

       

MBLOCK Message block allocation data.

       

DBLK TOT Total stream buffers.

       

DBLK4 4 byte stream buffer.

       

BLK16 16 byte stream buffer.

       

BLK64 64 byte stream buffer.

       

BLK128 128 byte stream buffer.

       

BLK256 256 byte stream buffer.

       

BLK512 512 byte stream buffer.

       

BLK1024 1024 byte stream buffer.

       

BLK2048 2048 byte stream buffer.

       

BLK4096 4096 byte stream buffer.

NFS Stats:

Displays statistics on both the client and server side of NFS.

       

NFS Client:

          

calls The total number of calls.

          

badcalls The number of rejected NFS calls.

          

nclget The number of times the client had to request a new handle for an NFS call.

          

clsleep The number of times a NFS call was blocked becasue no client was currently availble. Please see man page on nfsclnt if this number is greater than 0.

          

null Breakdown of NFS calls by procedure.

       

NFS server:

          

calls The total number of calls.

          

badcalls The number of rejected NFS calls.

          

null Breakdown of NFS calls by procedure.

       

RPC client:

          

calls The total number of calls made to all NFS servers.

          

badcalls The number of RPC calls that returned an error.

          

retrans The number of calls that were retransmitted because not reponse was recieved from the NFS server within the timeout period.

          

badxid Indicates that the server is recieving some retransmitted requests, but is taking a long time to reply to all NFS requests.

          

timeout Number of calls that timed out waiting for a server response.

          

wait The number of calls that had to wait on a busy client handle to be refreshed.

          

peekerrs The number of 'peek' into call message that failed.

          

badresps The number of minimal reply message size failures.

       

RPC server:

          

calls The total number of NFS RPC calls made to this server, from all clients.

          

badcalls The number of RPC calls that were rejected, before the request was passed to the NFS service routines.

          

nullrecv The number of times an nfsd daemon is scheduled to run but finds that there is no packet on the NFS service socket queue.

          

badlen The RPC request recieved by the server was too short.

          

xdrcall The XDR headers in the packet are malformed.

Sysinfo:

Displays the "sysinfo" data structure. The following is displayed:

       

bread The number of block reads during this interval.

       

bwrite The number of block writes during this interval.

       

lread The number of logical reads during this interval.

       

lwrite The number of logical writes during this interval.

       

phread The number of physical reads during this interval.

       

phwrite The number of physical writes during this interval.

       

swapin The number of swap in's during this interval.

       

swapout The number of swap out's during this interval.

       

bswapin The number of block swap in's during this interval.

       

bswapout The number of block swap out's during this interval.

       

iget The number of iget's during this interval.

       

namei The number of namei's during this interval.

       

dirblk The number of dirblk's during this interval.

       

readch The number of character's read during this interval.

       

writech The number of character's written during this interval.

       

rawch The number of ????????????????????????????????????????.

       

canch The number of ????????????????????????????????????????.

       

outch The number of ????????????????????????????????????????.

       

msg The number of ????????????????????????????????????????.

       

sema The number of ????????????????????????????????????????.

       

maxmem The amount of memory that is availble to user processes.

       

frmem The amount of memory that is free to user processes.

       

mem used The percent of memory that is being used.

       

nswap The amount of swap space available.

       

frswp The amount of free swap space available.

       

swp used The percent of swap being used.

       

availswp The amount of available swap.

       

pswitch The number of context switches during this interval.

       

syscall The number of system calls during this interval.

       

sysread The number of system reads during this interval.

       

syswrit The number of system writes during this interval.

       

sysfork The number of system forks during this interval.

       

sysexec The number of system execs during this interval.

       

runque The number of processes ready to run.

       

runocc The number of processes ????????????.

       

swpque The number of processes ????????????.

       

swpocc The number of processes ????????????.

       

vfault The number of faults.

       

demand The number of demands.

       

pfault The number of page faults.

       

cw The number of ??????.

       

steal The number of ??????.

       

frdpgs The number of ??????.

       

vfpg The number of ??????.

       

sfpg The number of ??????.

       

vspg The number of ??????.

       

sspg The number of ??????.

       

pnpfault The number of ??????.

       

wrtfault The number of ??????.

       

unmodsw The number of ??????.

       

unmodfl The number of ??????.

       

psoutok The number of ??????.

       

psinfai The number of ??????.

       

psinok The number of ??????.

       

rsout The number of ??????.

       

rsin The number of ??????.

       

pages from

          

swap

          

cache

          

file

VBT:

Displays the "v", "bootinfo", "tune", "bs_bootstring", & "strgCfg" data structure. The following is displayed:

       

Var

          

v_autoup Age (in seconds) before bdflush writes delayed-write buffer.

          

v_buf Number of I/O buffers

          

v_clist Number of clists allocated

          

v_file Size of file table.

          

v_hbuf Hash buffers (power of 2)

          

v_inode Size of incore inode table

          

v_maxpmem Maximum physical memory to use (if 0, then use all available physical memory); in pages.

          

v_maxup Max processes per user

          

v_mount Size of mount table

          

v_pbuf Number of physical I/O buffers.

          

v_proc Size of proc table

          

v_region Number of regions allocated.

          

v_vhndfrac Fraction of maxmem limits vhand.

       

Bootinfo

          

basemem The base memory available.

          

extmem The extended memory available.

          

bflags The bootflags in hexidecimal .

          

memory available The memory available and what it is being used for.

       

Tune

          

t_ageintvl Age process every so many seconds

          

t_bdflushr The rate at which bdflush is run in seconds.

          

t_gpgshi Once we start to steal pages, don't stop until freemem > t_getpgshi.

          

t_gpgslo If freemem < t_getpgslow, then start to steal pages from processes.

          

t_gpgsmsk Mask used by getpages to determine whether a page is stealable. The page is stealable if pte & t_gpgsmskis == 0.

          

t_maxfc The maximum number of pages which will be saved up and freed at once.

          

t_maxsc The maximum number of pages which will be swapped out in a single operation.

          

t_maxumem The maximum size of a user's virtual address space in pages.

          

t_minarmem The minimum available resident (not swapable) memory to maintain in order to avoid deadlock. In pages.

          

t_minasmem The minimum available swapable memory to maintain in order to avoid deadlock. In pages.

       

Boot String Displays the boot string of the system.

       

Boot configuration Displays the device configuration of the system.

Disk Stats.:

Displays activity for block devices. e.g., disk or tape drive. The activity reported is:

       

Device # The device.

       

%Busy Portion of time that the device was busy servicing a transfer request during the interval.

       

AvQue Average number of requests outstanding during the interval.

       

r+w/s Number of data transfers from or to the device per second during the interval.

       

blks/s Number of bytes transferred in 512-byte units per second during the interval.

       

AvWait Average time in milliseconds that the transfer requests wait idly on the queue.

       

AvServ Average time in miliseconds to be serviced ( which for disks includes seek, rotational latency, and data transfer times).

MEM:

Displays the following:

       

% Memory Used Displays average and current memory usages as a percent of total memory.

       

% Swap Used Displays average and current swap usages as a percent of total swap.

       

% Avail. Swap Used Displays average and current available swap usages as a percent of total available swap.

OPTIONS

Command line options allow the user to set specific colors and threshold values. xsw can connect to an unlimited number of servers.

Xsw Standard Options -display displayName - Alternate display -help - prints out all options to stdout. -version - prints out the version of xsw. -server host:[window,window,...] - connects to host and pops up appropriate resource window. The follwing resource windows are available: cpu,wait,cache,other,pscpu,psio,psmem,streams nfs,sysinfo,vbt,disk,mem -geometry geometry - Geometry. -title title - The title. -bg color background:color Background color. -fg color foreground:color Foreground color. -fn font font:font Default font.

Xsw Generic Options -labelc color labelColor:color The color of text labels. -usersc color userColor:color The color of the user's window. -intervalc color IntervalColor:color The color of target window. -actintervalc color ActiveIntervalColor The color of actual window. -actintervalwc color ActualIntervalWarningColor:color The color of actual window when its time is +/-10% of target. -actintervalac color ActualIntervalAlarmColor:color The color of actual window when its time is +/-30% of target. -titlebfg color title_barfgColor:color The text background color for window title bars. -titlebbg color title_barbgColor:color The text foreground color for window title bars. -auxbtnonbgc color auxButtonOnBackground:color The Auxillary Buttons' "ON" Background. -auxbtnonffgc color auxButtonOnForeground:color The Auxillary Buttons' "ON" Foreground. -auxbtnoffbgc color auxButtonOffBackground:color The Auxillary Buttons' "OFF" Background. -auxbtnofffgc color auxButtonOffForeground:color The Auxillary Buttons' "OFF" Foreground. -numericc color numericColor:color The Numeric color. -numericwc color numericWarningColor:color The Numeric Warning color. -numericac color numericAlarmColor:color The Numeric Alarm color. -snumericc color staticNumericColor:color The Static Numeric color

Xsw CPU Window Options -uc color userColor:color The User CPU percentage scale color. -kc color kernelColor:color The Kernel CPU percentage scale color. -bc color breakColor:color The Break CPU percentage scale color.

Xsw Wait Window Options -ic color ioColor:color The I/O WAIT percentage scale color. -pc color pioColor:color The Page I/O WAIT percentage scale color. -sc color swapColor:color The Swap I/O WAIT percentage scale color.

Xsw MEM Window Options -memusedc color memUsedColor:color The Memory percent used scale color. -memusedwc color memUsedWarningColor:color The Memory percent used warning scale color. -memusedac color memUsedAlarmColor:color The Memory percent used alarm scale color. -muwt threshhold memUsedWarningThreshhold:threshhold The Memory Warning percent Threshhold. -muat threshhold memUsedAlarmThreshhold:threshhold The Memory Alarm percent Threshhold. -swapusedc color swapUsedColor:color The Swap memory percent used scale color. -swapusedwc color swapUsedWarningColor:color The Swap memory percent used warning scale color. -swapusedac color swapUsedAlarmColor:color The Swap memory percent used alarm scale color. -suwt threshhold\fR swapUsedWarningThreshhold:threshhold\fR The Swap Warning percent Threshhold. -suwt threshhold\fR swapUsedAlarmThreshhold:threshhold\fR The Swap Alarm percent Threshhold. -availswapusedc color availSwapUsedColor:color The Avail. Swap memory percent used scale color. -availswapusedwc color availSwapUsedWarningColor:color The Avail. Swap memory percent used warning scale color. -availswapusedac color availSwapUsedAlarmColor:color The Avail. Swap memory percent used alarm scale color. -asuwt threshhold availSwapUsedWarningThreshhold:threshhold The Avail. Swap Warning percent Threshhold. -asuat threshhold availSwapUsedAlarmThreshhold:threshhold The Avail. Swap Alarm percent Threshhold.

Xsw Cache Window Options -cachereadhitc color cacheReadHitColor:color The Read Cache Hit scale color. -cachewritehitc color cacheWriteHitColor:color The Write Cache Hit scale color. -cachereadmissc color cacheReadMissColor:color The Read Cache Miss scale color. -cachewritemissc color cacheWriteMissColor:color The Write Cache Miss scale color. -cachereadmisswc color cacheReadMissWarningColor:color The Read Cache Miss Warning scale color. -cachewritemisswc color cacheWriteMissWarningColor:color The Write Cache Miss Warning scale color. -cachereadmissac color cacheReadMissAlarmColor:color The Read Cache Miss Alarm scale color. -cachewritemissac color cacheWriteMissAlarmColor:color The Write Cache Miss Alarm scale color. -rca percent readCacheAlarmThreshhold:percent The Read Cache Hit alarm percentage. -wca percent writeCacheAlarmThreshhold:percent The Write Cache Hit alarm percentage. -rcw percent readCacheWarningThreshhold:percent The Read Cache Hit warning percentage. -wcw percent writeCacheWarningThreshhold:percent The Write Cache Hit warning percentage.

Xsw Other Window Options -nfilec color nfileColor:color The NFILE percentage scale color. -ninodec color ninodeColor:color The NINODE percentage scale color. -nprocc color nprocColor:color The NPROC percentage scale color. -nregionc color nregionColor:color The NREGION percentage scale color. -ncblocksc color ncblocksColor:color The NCBLOCKS percentage scale color. -nfileac color nfileAlarmColor:color The NFILE Alarm percentage scale color. -ninodeac color ninodeAlarmColor:color The NINODE Alarm percentage scale color. -nprocac color nprocAlarmColor:color The NPROC Alarm percentage scale color. -nregionac color nregionAlarmColor:color The NREGION Alarm percentage scale color. -ncblocksac color ncblocksAlarmColor:color The NCBLOCKS Alarm percentage scale color. -nfileat threshhold nfileAlarmThreshhold:threshhold The NFILE Alarm percent Threshhold. -ninodeat threshhold ninodeAlarmThreshhold:threshhold The NINODE Alarm percent Threshhold. -nprocat threshhold nprocAlarmThreshhold:threshhold The NPROC Alarm percent Threshhold. -nregionat threshhold nregionAlarmThreshhold:threshhold The NREGION Alarm percent Threshhold. -ncblocksat threshhold ncblocksAlarmThreshhold:threshhold The NCBLOCKS Alarm percent Threshhold. -nfilewc color nfileWaringColor:color The NFILE Warning percentage scale color. -ninodewc color ninodeWarningColor:color The NINODE Warning percentage scale color. -nprocwc color nprocWarningColor:color The NPROC Warning percentage scale color. -nregionwc color nregionWarningColor:color The NREGION Warning percentage scale color. -ncblockswc color ncblocksWarningColor:color The NCBLOCKS Warning percentage scale color. -nfilewt percent nfileWarningThreshhold:percent The NFILE Warning percent Threshhold. -ninodewt percent ninodeWarningThreshhold:percent The NINODE Warning percent Threshhold. -nprocwt percent nprocWarningThreshhold:percent The NPROC Warning percent Threshhold. -ncblockswt percent ncblocksWarningThreshhold:percent The NCBLOCKS Warning percent Threshhold.

Xsw PS Mem Window Options -psmemc color psMemColor:color The PS Memory color -psmemgrowc color psMemGrowingColor:color The PS Memory growing color. -psmemshrinkc color psMemShrinkingColor:color The PS Memory shrinking color. -psmemnewc color psMemNewColor:color The PS Memory new color.

Xsw PS CPU Window Options -pscpuidlec color psCpuIdleColor:color The PS CPU idle color. -pscpuactivec color psCpuActiveColor:color The PS CPU active color . -pscpunewc color psCpuNewColor:color The PS CPU new color. -pscpurunc color psCpuRunningColor:color The PS CPU running color.

Xsw PS IO Window Options -psioidlec color psioidlec:color The PS IO idle color. -psioactivec color psioactivec:color The PS IO active color. -psionewc color psionewc:color The PS IO new color.

LIMITATIONS

FILL IN THE BLANK
 

AUTHOR

SEE ALSO

Index

NAME

SYNTAX

DESCRIPTION

OPTIONS

LIMITATIONS

AUTHOR

SEE ALSO